<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
<HTML><HEAD>
		<TITLE>User's Reference - Construct</TITLE>
		<META HTTP-EQUIV="keywords" CONTENT="GRAPHICS VISUALIZATION VISUAL PROGRAM DATA
MINING">
	<meta http-equiv="content-type" content="text/html;charset=ISO-8859-1">
</HEAD><BODY BGCOLOR="#FFFFFF" link="#00004b" vlink="#4b004b">
		<TABLE width=510 border=0 cellpadding=0 cellspacing=0>
			<TR>
				<TD><IMG src="../images/spacer.gif" width=80 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=49 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=24 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=100 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=3 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=127 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=6 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=50 height=1></TD>
				<TD><IMG src="../images/spacer.gif" width=71 height=1></TD>
			</TR>
			<TR>
				<TD colspan=9><IMG src="../images/flcgh_01.gif" width=510 height=24 alt="OpenDX - Documentation"></TD>
			</TR>
			<TR>
				<TD colspan=2><A href="../allguide.htm"><IMG src="../images/flcgh_02.gif" width=129 height=25 border="0" alt="Full Contents"></A></TD>
				<TD colspan=3><A href="../qikguide.htm"><IMG src="../images/flcgh_03.gif" width=127 height=25 border="0" alt="QuickStart Guide"></A></TD>
				<TD><A href="../usrguide.htm"><IMG src="../images/flcgh_04.gif" width=127 height=25 border="0" alt="User's Guide"></A></TD>
				<TD colspan=3><B><A href="../refguide.htm"><IMG src="../images/flcgh_05d.gif" width=127 height=25 border="0" alt="User's Reference"></A></B></TD>
			</TR>
			<TR>
				<TD><A href="refgu038.htm"><IMG src="../images/flcgh_06.gif" width=80 height=17 border="0" alt="Previous Page"></A></TD>
				<TD colspan=2><A href="refgu040.htm"><IMG src="../images/flcgh_07.gif" width=73 height=17 border="0" alt="Next Page"></A></TD>
				<TD><A href="../refguide.htm"><IMG src="../images/flcgh_08.gif" width=100 height=17 border="0" alt="Table of Contents"></A></TD>
				<TD colspan=3><A href="refgu009.htm"><IMG src="../images/flcgh_09.gif" width=136 height=17 border="0" alt="Partial Table of Contents"></A></TD>
				<TD><A href="refgu175.htm"><IMG src="../images/flcgh_10.gif" width=50 height=17 border="0" alt="Index"></A></TD>
				<TD><A href="../srchindx.htm"><IMG src="../images/flcgh_11.gif" width=71 height=17 border="0" alt="Search"></A></TD>
			</TR>
		</TABLE>
		<H3><A name="HDRCONSTRU" ></A>Construct</H3>
		<A NAME="IDX437"></A><A NAME="IDX438"></A>
<A NAME="IDX439"></A>
<P><STRONG>Category</STRONG>
<P>
<A HREF="refgu008.htm#HDRCATREL">Realization</A>
<P><STRONG>Function</STRONG>
<P>
Constructs a field with regular connections.
<P><STRONG>Syntax</STRONG>
<PRE><STRONG>
output</STRONG> = Construct(<STRONG>origin, deltas, counts, data</STRONG>);
</PRE>
<P><STRONG>Inputs</STRONG>
<BR>
<TABLE BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Name
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Type
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">Default
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">Description
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>origin</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">vector list
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">input dependent
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">origin for positions or a list of
positions
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>deltas</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">vector list
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">input dependent
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">deltas for positions
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>counts</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">integer or vector
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">input dependent
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">number of positions in each
dimension
</TD></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%"><TT><STRONG>data</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">value list or string list
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="20%">no default
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="40%">data, last index varies fastest
</TD></TR></TABLE>
<P><STRONG>Outputs</STRONG>
<BR>
<TABLE BORDER>
<TR>
<TH ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Name
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">Type
</TH><TH ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">Description
</TH></TR><TR>
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%"><TT><STRONG>output</STRONG></TT>
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="25%">field
</TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="50%">the output field
</TD></TR></TABLE>
<P><STRONG>Functional Details</STRONG>
<P>
This module creates a field by defining its positions and connections.
<TABLE CELLPADDING="3">
<TR VALIGN="TOP"><TD><P><B><TT><STRONG>origin</STRONG></TT>
</B></TD><TD><P>specifies either the origin of a field with regular positions or
a list of positions for a field with irregular positions.
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>deltas</STRONG></TT>
</B></TD><TD><P>should be used only for creating a field with regular
connections.
It specifies one of the following:
<UL COMPACT>
<LI>a vector of the same shape as <TT><STRONG>origin</STRONG></TT>, if
<TT><STRONG>origin</STRONG></TT> is specified
<LI>a list of vectors that match <TT><STRONG>origin</STRONG></TT>, the
number of vectors being equal to the number of dimensions in
<TT><STRONG>origin</STRONG></TT>.
(This specification can be used to define a grid with non-orthogonal
axes.)
</UL>
<P>
If <TT><STRONG>origin</STRONG></TT> is not specified, the dimensionality of
the output positions is derived from the dimensionality of
<TT><STRONG>deltas</STRONG></TT>.
The default value is a unit vector.
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>counts</STRONG></TT>
</B></TD><TD><P>specifies the number of positions in each dimensions for a field
with regular connections.
The module interprets this parameter according to the value specified
by <TT><STRONG>origin</STRONG></TT>.
If <TT><STRONG>origin</STRONG></TT> specifies:
<UL COMPACT>
<LI><I>a single vector:</I> the field will have regular positions
and regular connections.
(If <TT><STRONG>counts</STRONG></TT> has been specified as a single number,
the module creates that number of positions in each dimension.)
<LI><I>a vector list:</I> the field will have irregular positions
and regular connections.
The product of the counts must match the number of positions given
by <TT><STRONG>origin</STRONG></TT>.
</UL>
<P>
To create a field consisting of just the items specified by
<TT><STRONG>origin</STRONG></TT> as the "positions"
component, do not specify
<TT><STRONG>counts</STRONG></TT>.
If the list of vectors contains more than one item, the output has, in
addition to the "positions" component containing the points
in <TT><STRONG>origin</STRONG></TT>, a "connections" component
of element type "lines".
</TD></TR><TR VALIGN="TOP"><TD><P><B><TT><STRONG>data</STRONG></TT>
</B></TD><TD><P>specifies one or more data values associated with the positions
or
connections of the field.
<P>
If specified, this parameter must be either a single value or a list of
values.
If it is a single value or a list with a length that matches the number
of positions &#91;e.g.,
<I>n<SUB>0</SUB>&times;n<SUB>1</SUB>...</I>,
where
<I>n<SUB>0</SUB></I>, <I>n<SUB>1</SUB></I>, ..., are the
<TT><STRONG>counts</STRONG></TT>&#93;, then
the output data component is dependent
on the "positions" component.
If the list has a length that matches the number of connection elements
(e.g., <I>(n<SUB>0</SUB>-1) &times; (n<SUB>1</SUB>-1) ...</I>),
then the output data is dependent on the "connections"
component.
Any other number of items in <TT><STRONG>data</STRONG></TT> is an error.
<P>
The type of the "data" component is the type of the input
<TT><STRONG>data</STRONG></TT>.
If <TT><STRONG>data</STRONG></TT> is a string list, the "data"
component will be TYPE&#95;STRING.
</TD></TR></TABLE>
<P><B>Note: </B>If none of the first three parameters is specified
(<TT><STRONG>origin</STRONG></TT>, <TT><STRONG>deltas</STRONG></TT>,
or <TT><STRONG>counts</STRONG></TT>), Construct creates an
empty field.
<P><STRONG>Components</STRONG>
<P>
Creates "positions" and "connections" components.
A "data" component is created if <TT><STRONG>data</STRONG></TT> is not
null.
<P><STRONG>Example Visual Programs</STRONG>
<PRE>
AnnotationGlyphs.net
ConnectingScatteredPoints.net
ProbeText.net
Sealevel.net
UsingColormaps.net
UsingStreakline.net
SIMPLE/Construct.net
</PRE>
		<P>
		<HR>
		<DIV align="center">
			<P><A href="../allguide.htm"><IMG src="../images/foot-fc.gif" width="94" height="18" border="0" alt="Full Contents"></A> <A href="../qikguide.htm"><IMG src="../images/foot-qs.gif" width="94" height="18" border="0" alt="QuickStart Guide"></A> <A href="../usrguide.htm"><IMG src="../images/foot-ug.gif" width="94" height="18" border="0" alt="User's Guide"></A> <A href="../refguide.htm"><IMG src="../images/foot-ur.gif" width="94" height="18" border="0" alt="User's Reference"></A></P>
		</DIV>
		<DIV align="center">
			<P><FONT size="-1">[ <A href="http://www.research.ibm.com/dx">OpenDX Home at IBM</A>&nbsp;|&nbsp;<A href="http://www.opendx.org/">OpenDX.org</A>&nbsp;] </FONT></P>
			<P></P>
		</DIV>
		<P></P>
	</BODY></HTML>
